/*
 *
 *  Copyright (C) 2012-2024
 *  All rights reserved, Designed By 杭州连线客信息技术有限公司
 *  注意：
 *  本软件为杭州连线客信息技术有限公司开发研制，未经购买不得使用
 *  购买后可获得全部源代码（禁止转卖、分享、上传到码云、github等开源平台）
 *  一经发现盗用、分享等行为，将追究法律责任，后果自负
 *
 */

package com.lxk.service.pms.api;

import com.lxk.service.core.Result;
import com.lxk.service.pms.request.CheckSkuStockParam;
import com.lxk.service.pms.request.ProductSkuUpdateStockParam;
import com.lxk.service.pms.request.QueryPmsParam;
import com.lxk.service.pms.request.QueryPmsSpuParam;
import com.lxk.service.pms.response.*;

import java.util.List;

/**
 * 商品模块
 *
 * @author huahua
 * 2024/8/20
 */
public interface PmsServiceApi {


    /**
     * 更具skuid查询商品sku
     *
     * @param skuId
     * @return
     */
    Result<PmsProductSkuDto> queryBySkuId(Long skuId);

    /**
     * 查询商品sku
     *
     * @return
     */
    Result<PmsProductSkuDto> querySkuByParam(QueryPmsParam param);

    /**
     * 查询sku列表
     *
     * @param param
     * @return
     */
    Result<List<PmsProductSkuDto>> querySkuListByParam(QueryPmsParam param);

    /**
     * 查询商品spu
     *
     * @return
     */
    Result<PmsProductSpuDto> querySpuByParam(QueryPmsSpuParam param);

    /**
     * 查询spu列表
     *
     * @param param
     * @return
     */
    Result<List<PmsProductSpuDto>> querySpuListByParam(QueryPmsSpuParam param);

    /**
     * 更具skuid列表查询商品sku
     *
     * @param skuIdList
     * @return
     */
    Result<List<PmsProductSkuDto>> queryBySkuIdList(List<Long> skuIdList);

    /**
     * 更具spuid查询商品spu
     *
     * @param spuId
     * @return
     */
    Result<PmsProductSpuDto> queryBySpuId(Long spuId);

    /**
     * 更具spuid列表查询商品spu
     *
     * @param spuIdList
     * @return
     */
    Result<List<PmsProductSpuDto>> queryBySpuIdList(List<Long> spuIdList, Boolean needSku);

    /**
     * 根据SKUID查询库存是否足够
     *
     * @param checkSkuStockParam
     * @return
     */
    Result<SkuCheckStockItemResult> checkStockBySkuId(CheckSkuStockParam checkSkuStockParam);

    /**
     * 根据SKUID列表查询库存是否足够
     *
     * @param checkList
     * @return
     */
    Result<PmsSkuCheckStockResult> checkStockBySkuIdList(List<CheckSkuStockParam> checkList);

    /**
     * SKUID加 库存接口。需要批量和单个,
     *
     * @param updateStockParam
     * @return
     */
    Result<SkuUpdateStockResult> addSkuStock(ProductSkuUpdateStockParam updateStockParam);

    /**
     * SKUID减 库存接口。需要批量和单个,
     *
     * @param updateStockParam
     * @return
     */
    Result<SkuUpdateStockResult> cutSkuStock(ProductSkuUpdateStockParam updateStockParam);

    /**
     * SKUID回滚预扣库存接口。需要批量和单个
     *
     * @param updateStockParam
     * @return
     */
    Result<SkuUpdateStockResult> rollbackPreSkuStock(ProductSkuUpdateStockParam updateStockParam);

    /**
     * SKUID预扣库存接口。需要批量和单个
     *
     * @param updateStockParam
     * @return
     */
    Result<SkuUpdateStockResult> preCutSkuStock(ProductSkuUpdateStockParam updateStockParam);

    /**
     * 预扣库存确认扣除
     */
    Result<SkuUpdateStockResult> actCutSkuStock(ProductSkuUpdateStockParam updateStockParam);
}
